Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

SetMoviePosterTime

The SetMoviePosterTime function sets the poster time for the movie. Since a movie poster is a still frame, it is defined by a point in time within the movie. The poster's time is expressed in the movie's time coordinate system. Your application can retrieve a poster's time by calling the GetMoviePosterTime function, which is described in the next section.

pascal void SetMoviePosterTime (Movie theMovie,
                                 TimeValue posterTime);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

posterTime

Contains the starting time for the movie frame that contains the poster image.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidTime	-2015	This time value is invalid

SEE ALSO

Your application can set the poster's boundary rectangle by calling the SetPosterBox function, which is described on page 2-103.